Notes & Actions Module

Testing Playbook

Comprehensive QA guide for the Notes & Actions module in CHAD2, covering creation, permissions, workflows, and Release 3 scope.

The Business

Understanding the purpose, value, and strategic importance of the Notes & Actions module in CHAD2.

📋Overview & Value Proposition

The Notes & Actions module enables ABC Staff (Chapter and National level) to communicate internally across the CHAD2 system. All notes and actions are directly tied to specific records—Companies, Individuals, Events, and Courses—creating an audit trail and accountability mechanism for organizational activities.

This module serves two critical functions:

  • Notes: Information-only records with no action required or individual assigned. Used for documentation, observations, and historical context.
  • Actions (Next Actions): Task-oriented records assigned to specific ABC staff with due dates and status tracking. Drive accountability and task completion.

The module also supports Global Notes/Actions (created from Selective Reporting Results), Action Checklists (predefined task sets), and Attachments (images, documents). Release 3 introduces significant enhancements to creation flows, permissions, and admin capabilities.

🎯Key Stakeholders & Permissions Model

The Notes & Actions module operates on a permission-driven model where access is determined by the underlying module permissions (Company, Individual, Event, Course) rather than a separate N&A permissions group.

Permission Levels (Level 1+):

  • Any user with Level 1 or higher permissions to the parent module can add and view notes/actions
  • Edit/Delete Rights are granular: Notes can only be edited/deleted by creator; Actions can be edited by creator OR assignee, but deleted only by creator
  • Completed Actions persist all original metadata (Assigned To, Due Date) but display as Type="Note" throughout the interface

This permission model ensures consistent access patterns across the system while maintaining appropriate edit/delete controls for audit and accountability.

🚀Release 3 Strategic Scope

In Scope for Release 3: Single Note/Action creation (Companies & Individuals), Global Notes/Actions from Selective Reporting Results, Action Checklists, Action Status workflow, Completed Actions behavior, Browse All screen with filters and default view changes, Dashboard widget enhancements, Notification badge improvements, Admin management (Categories, Types, Checklists), Attachments (image upload), and critical bug fixes from UAT feedback.

Out of Scope: Event/Education permissions integration, Student/Event/Course notes, full global contexts for all modules, module-specific dashboard widgets, multi-module global notes.

QA Note Release 3 reduces scope significantly. Testing must focus on Companies & Individuals paths, Selective Reporting integration, and the new Browse default filter (Actions Assigned to Me). Events/Courses/Students are handled in later releases.

💼Business Rules & System Integrity

The Notes & Actions module enforces strict business rules to maintain data integrity and prevent duplicate work:

  • Completed Actions Visibility: Completed actions display with Status="Complete" and Type="Note" but retain assignee and due date for historical audit
  • Global Note Error Handling: Global notes may fail on individual records; the system must capture and report partial failures without rolling back successful records (ABC-2975)
  • Duplicate Prevention: The system prevents creation of duplicate actions on the same record with identical parameters (ABC-1923)
  • Prefixed Text: Global Notes/Actions are marked with origin prefix (e.g., "[Selective Reporting]") for traceability
  • Browse Default Filter: Changed from all actions to "Actions Assigned to Me" for user-centric task management (ABC-2005)

How It Works

Detailed workflows for creating, editing, viewing, and managing notes and actions across CHAD2.

Single Note/Action Creation Flow (Release 3: Companies & Individuals)
Release 3

Entry Point: From Company Add/Edit/View or Individual Add/Edit/View screens, users access a "Add Note" or "Add Action" button/modal.

User navigates to Company/Individual record ↓ Clicks "Add Note" or "Add Action" button ↓ Modal/Form opens with pre-populated context ↓ User selects: Type, Category, Related To Type, Related To Record ID ↓ Enters: Text, Note Date (defaults today), optional Attachment ↓ For Actions ONLY: Assigns to staff, sets Due Date, selects Status ↓ Clicks "Save" ↓ Record created, confirmation toast displayed ↓ User redirected to Browse All or remains on current record

Data Fields Required:

  • Note/Action Common: Related To Type, Related To Record ID, Created By, Created Date/Time, Last Modified Date, Modified By, Note Date, Note Category, Note Type (optional per ABC-1960), Note Text, Attachment
  • Action Only: Assigned To (defaults to Created By), Assigned To Date, Due Date (renamed from "Action Date" per ABC-1924), Action Category, Action Type, Action Text, Status, Completed Date

Note Date Behavior: Defaults to current date but can be back-dated. Users may record historical notes/actions. This field is required.

Created By Default: Automatically set to current logged-in user. Cannot be changed during creation.

Assigned To Default (Actions): Defaults to the current user (Created By) but can be reassigned during creation.

Global Notes/Actions from Selective Reporting (Release 3)
Release 3

Entry Point: From Selective Reporting Results (Companies or Individuals), users can bulk-create Notes or Actions applied to all selected records.

User runs Selective Reporting (Companies or Individuals) ↓ Selects multiple records in result set ↓ Clicks "Create Global Note" or "Create Global Action" ↓ Modal opens with bulk creation form ↓ User enters: Note/Action text, Type, Category, Due Date (if Action), Assigns to (if Action) ↓ Clicks "Create on All Selected" ↓ System loops through each selected record ↓ Creates individual Note/Action with prefixed text (e.g., "[Selective Reporting]") ↓ Captures successes and failures ↓ Displays completion summary (X created, Y failed)

Prefixed Text Behavior: Global Notes/Actions automatically prepend origin context. Example: "[Selective Reporting] Your note text here". This aids traceability and prevents confusion about note origin.

Error Handling (ABC-2975): If creation fails on some records, the system does NOT roll back successful records. Instead, it reports a summary: "Created on 45 records, failed on 2 (insufficient permissions)". Users can manually retry failed records.

Duplicate Prevention (ABC-1923): The system prevents creation of duplicate global actions with identical parameters. If user attempts to create the same global action twice, a warning is displayed.

Action Checklists (Release 3)
Release 3

Purpose: Predefined sets of actions that can be bulk-attached to records (Company or Individual). Checklists streamline repetitive task creation and ensure consistency.

Creation Flow: Admin users create checklists with the following attributes:

  • Checklist Name: Display name (e.g., "New Company Onboarding")
  • Description: Purpose and scope
  • Module: Target module (Company or Individual)
  • Enabled/Disabled: Toggle availability
  • Actions: List of action tasks with future date offsets (e.g., +1 day, +7 days for Due Date calculation)

Attachment Flow: From a Company/Individual record, users select "Attach Checklist" → choose checklist → confirm → system creates all actions with calculated due dates (base date + offset).

Copying Checklists: Admin can copy existing checklists to create variations without manual recreation.

Default Assignee: Actions from checklists default to current user but can be overridden during attachment.

Browse All Notes & Actions Screen
Release 3

Entry Point: Main Navigation > Notes & Next Actions

Default Filter (Updated per ABC-2005): "Actions Assigned to Me" (previously showed all actions; changed for user-centric task management)

Available Filters:

  • Type (Note, Action, Completed Action)
  • Related To Type (Company, Individual, Event, Course)
  • Related To (string search by record name)
  • Assigned To (staff member dropdown)
  • Action Due Date (date range picker)
  • Status (Open, Complete)

Default Sort: Type ascending (Actions above Notes), then Date descending (newest first)

Display Fields: Type, Related To Type, Related To Name, Created By, Assigned To, Date, Due Date, Status, Last Modified Date, Text preview

View Modal (Read-Only per ABC-1927): Clicking a record opens a modal showing full details. Users cannot edit from this modal; they must use the Edit button to open the edit form.

Pagination: Results paginated (25 items per page default); users can adjust page size.

Export (ABC-1755): Users can export filtered results to Excel or PDF with all visible fields.

Action Status & Completion Workflow
Release 3

Status Values: Actions have two statuses: Open and Complete. Notes do not have status.

Marking Complete: Users can mark actions complete from:

  • The Browse All screen (checkbox/button on action row)
  • The Edit Action form (Status dropdown set to "Complete")
  • The Dashboard widget (Quick Action button)

Completed Action Behavior (ABC-1922):

  • Type displays as "Note" throughout the interface
  • Status shows "Complete"
  • Assigned To and Due Date persist and remain visible for historical audit
  • Completed Date automatically captured when status changes to Complete
  • Completed actions are excluded from the default "Actions Assigned to Me" filter but can be viewed with custom filters

Edit/Delete Rights on Completed Actions: Creator can still edit completed actions (reopen if needed); assignee cannot edit completed actions.

Dashboard Widget & Notifications
Release 3

Dashboard Widget: Displays all user's incomplete actions on the main dashboard. Shows: Date Assigned, Assigned-by (Created By), Related-To Entity. Sorted descending by date (oldest assignments first to surface urgent items).

Widget Interactions:

  • Click action to open view modal
  • Mark complete button toggles status
  • Click related entity to navigate to record
  • Widget refreshes on every page load

Notification Badge: Main navigation shows a badge count of incomplete actions. Updates in real-time when actions are created or completed.

Notification Dropdown: Bell icon in upper right shows notification history. Clicking a notification navigates to Browse All screen with "Actions Assigned to Me" filter applied.

Notification Triggers:

  • Action created and assigned to current user
  • Action reassigned to current user
  • Action due date approaching (48-hour warning)
  • Action due date passed (overdue notification)
Edit & Delete Operations
Core Feature

Edit Rights Model:

  • Notes: Only creator can edit or delete
  • Actions: Creator OR assignee can edit; only creator can delete

Edit Form Fields: All fields can be updated except Created By and Created Date/Time. Last Modified Date and Modified By are automatically updated.

Delete Behavior: When a note/action is deleted, it is removed from the database. A soft-delete audit log is maintained for compliance (not visible in UI but available for compliance queries).

Attachment Edit/Delete: Users can add, view, or remove attachments from the edit form. Removing an attachment does not delete the associated note/action.

Attachment Management (Image Upload Support)
Release 3

Attachment Support (ABC-1919): Users can attach images and documents to notes/actions during creation or edit.

Supported File Types: PNG, JPG, PDF, DOCX, XLS (configurable; default to image formats)

File Size Limits: Maximum 10 MB per file; maximum 5 files per note/action (configurable)

Upload Flow:

  • User clicks "Add Attachment" in form
  • Native file picker opens
  • User selects file(s)
  • File uploads asynchronously (progress bar shown)
  • Thumbnail/preview displayed for images
  • Attachment name editable

View/Download: In view modal, attachments display with preview (images) or icon (documents). Users can download or open in new tab.

Virus Scanning: All uploaded files are scanned for malware. If detected, upload is rejected with user-friendly error message.

Glossary

Key terms and definitions specific to the Notes & Actions module.

Term Definition
Note An information-only record attached to an entity (Company, Individual, Event, Course). No action required, no individual assigned. Used for documentation and historical context.
Next Action / Action A task-oriented record attached to an entity, assigned to a specific ABC staff member with a due date and status. Drives accountability and task completion.
Completed Action An action whose status has been marked "Complete". Displays as Type="Note" in the interface but retains Assigned To, Due Date, and Completed Date for audit.
Global Note/Action A note or action created from Selective Reporting Results and applied to multiple entity records at once. Automatically prefixed with origin context (e.g., "[Selective Reporting]").
Action Checklist A predefined set of actions that can be bulk-attached to records. Admin-managed. Includes future date offsets for automatic due date calculation.
Related To Type The type of entity a note/action is attached to: Company, Individual, Event, or Course. Release 3 supports Company and Individual only.
Related To Record ID The unique identifier of the specific entity record (Company ID, Individual ID, etc.) to which the note/action is attached.
Note Category An admin-managed classification for notes. Examples: General, Follow-up, Issue, Documentation. Used for filtering and organization.
Note Type An optional admin-managed classification for notes. Optional per ABC-1960. Examples: Call, Email, In-Person Meeting. Optional during creation.
Action Category An admin-managed classification for actions. Examples: Follow-up Call, Documentation, Proposal Review, Support Request.
Action Type An admin-managed classification for actions with optional prefix. Examples: "Call [C]", "Email [E]", "Meeting [M]". Prefix appears on Browse display.
Created By The ABC staff member who created the note/action. Automatically set to current user; cannot be changed.
Assigned To The ABC staff member responsible for completing an action. Can be set during creation or reassigned later. Actions default to Created By.
Note Date The date associated with the note/action. Defaults to current date but can be back-dated. Required field.
Due Date For actions only. The target completion date. Renamed from "Action Date" per ABC-1924. Used for sorting and overdue detection.
Assigned To Date The date the action was assigned to the assignee. Automatically set when action is created or reassigned.
Status For actions only. Values: Open (default), Complete. Changed via edit form or dashboard widget quick-action.
Completed Date For actions only. Automatically captured when status changes to Complete. Null until action is marked complete.
Browse All Screen Primary interface for viewing and managing all notes/actions. Supports filtering, sorting, and export. Default filter: "Actions Assigned to Me" (per ABC-2005).
Selective Reporting The CHAD2 advanced search and reporting feature. Used as entry point for global note/action creation in Release 3.
Prefixed Text Automatically prepended to global notes/actions to indicate origin. Example: "[Selective Reporting] Your note text". Aids traceability.
Attachment An image, document, or file attached to a note/action. Supports PNG, JPG, PDF, DOCX, XLS (configurable). Max 10 MB; max 5 per record (configurable).
Dashboard Widget A summary panel on the main dashboard showing user's incomplete actions. Sorted by age (oldest first). Includes quick-complete button.
Notification Badge A count indicator on the Notes & Actions main navigation item showing number of incomplete actions assigned to current user.
Duplicate Prevention System mechanism preventing creation of duplicate global actions with identical parameters. Triggers warning if user attempts duplicate. (ABC-1923)
Permission Model Access to notes/actions is driven by parent module permissions (Company, Individual, Event, Course). No separate N&A permission group. Level 1+ required to add/view.

Test Strategy

Comprehensive approach to testing the Notes & Actions module across functional areas, user flows, and Release 3 scope.

🎯Testing Principles & Approach

The Notes & Actions module testing strategy is built on persona-driven, end-to-end flow validation. Given the module's central role in internal communication and task management, tests must cover:

  • User Personas: Chapter Staff (add/view notes), National Staff (bulk create global notes), Admins (manage categories/types/checklists)
  • Core Workflows: Create single, create global, attach checklist, mark complete, view/filter/sort, export
  • Permission Boundaries: Edit/delete rights, visibility by permission level, cross-module permission inheritance
  • Data Integrity: No duplicates, prefixed text on globals, audit trail accuracy, soft-delete logging
  • Edge Cases: Back-dated notes, concurrent edits, reassignment flows, permission changes mid-action
  • Integration Points: Selective Reporting integration, Dashboard widget refresh, Notification badge updates
  • Release 3 Scope: Companies & Individuals only, Selective Reporting globals, Action Checklists, Browse default filter change

📊Test Coverage by Feature Area

Single Note/Action Creation

Scope: Companies & Individuals only (Release 3). Test creation flows from Add/Edit/View screens. Validate all required and optional fields. Test note dating (current, back-dated), assigned-to defaults, status defaults.

Priority: Critical. Essential feature used daily.

Global Notes/Actions

Scope: Created from Selective Reporting Results (Companies & Individuals). Test bulk creation, prefixed text, partial failure handling (ABC-2975), duplicate prevention (ABC-1923).

Priority: Critical. High-volume use case.

Action Checklists

Scope: Admin creation, attachment to records, date offset calculations, copy functionality. Test all CRUD operations. Validate enabled/disabled state.

Priority: High. Reduces manual effort for repetitive tasks.

Browse All Screen

Scope: Default filter (Actions Assigned to Me, per ABC-2005), all filter combinations, sort order, pagination, export (ABC-1755), view modal read-only (ABC-1927).

Priority: Critical. Primary user interface.

Action Status Workflow

Scope: Mark complete from Browse, Edit form, Dashboard widget. Test status persistence, Completed Action display (ABC-1922), exclusion from default filter, edit/delete rights post-completion.

Priority: Critical. Core task management.

Permissions & Edit/Delete

Scope: Test creator-only delete, creator/assignee edit, permission inheritance from parent module, Level 1+ requirement. Test with various permission levels.

Priority: Critical. Security and audit requirement.

Dashboard Widget

Scope: Display all incomplete actions, sort by age (oldest first), quick-complete, click-through to record, widget refresh on page load.

Priority: High. User-facing daily interface.

Attachments

Scope: Image upload (ABC-1919), file type validation, size limits, virus scanning, preview/download, attach during create/edit.

Priority: Medium. Nice-to-have but increasingly used.

Release 3 Scope & Regression Focus

Key UAT Feedback Fixes to Validate:

  • ABC-1924: Verify "Action Date" renamed to "Due Date" everywhere (forms, Browse, modal, filters, exports)
  • ABC-1960: Verify Note Type is optional (can create note without selecting type)
  • ABC-1927: Verify Browse view modal is read-only (no edit buttons, edit must use Edit button)
  • ABC-1928: Validate button labels match UX standards (Submit, Save, Create vs Save & Close)
  • ABC-2005: Verify Browse default filter changed to "Actions Assigned to Me"
  • ABC-1755: Test export to Excel and PDF with all visible fields, proper formatting
  • ABC-1919: Test image upload, file type validation, size limits, virus scanning
  • ABC-1922: Verify complete action flow and Completed Action display as Type="Note"
  • ABC-1923: Test duplicate action prevention; verify warning message shown
  • ABC-2975: Test global note error handling; verify partial failures reported correctly
  • ABC-3076, ABC-3082, ABC-3098, ABC-3418, ABC-3609: Validate all UAT feedback fixes (button labels, error messages, edge cases)

🔄Integration Testing Strategy

Selective Reporting Integration: Test that Selective Reporting filters (Company, Individual results) correctly expose "Create Global Note/Action" buttons. Test that filtering narrows record set correctly for global note scope.

Dashboard Widget Integration: Test that Dashboard widget displays on main page, refreshes on every page load, and reflects real-time action changes (create, complete). Test click-through navigation.

Notification Integration: Test badge count on main nav, bell icon dropdown, notification generation (create, reassign, overdue), and click-through to Browse with filter applied.

Permission Inheritance: Test that adding a note/action requires Level 1+ permission to parent module. Test that permission changes (user loses access) are reflected in Note/Action visibility.

Risk-Based Testing Priorities

Critical Path (Test First):

  1. Single action creation from Company & Individual records
  2. Mark action complete (all entry points: Browse, Edit, Dashboard)
  3. Browse All default filter ("Actions Assigned to Me")
  4. Global note creation from Selective Reporting
  5. Edit/delete permissions (creator vs assignee vs other users)

High Priority (Test Thoroughly):

  1. Action Checklists creation, attachment, date offset calculation
  2. Browse filters and sort order
  3. Completed Action display and behavior
  4. Global note error handling and partial failure reporting
  5. Dashboard widget display and interactivity

Medium Priority (Spot-Check):

  1. Attachment upload and virus scanning
  2. Export to Excel/PDF
  3. Notification badge and bell dropdown
  4. Admin category/type/checklist management
  5. Back-dated note entry

Business Rules & Gotchas

Critical business logic, edge cases, and common pitfalls in the Notes & Actions module.

Completed Actions Display & Persistence
ABC-1922

Key Rule: When an action is marked complete, it displays as Type="Note" throughout the interface, but retains all original metadata (Assigned To, Due Date, Completed Date).

Why This Matters: Completed actions must appear in historical records and audit trails but should not appear in active task lists by default. This dual identity (Type="Note" display + Action metadata retention) creates audit trail completeness.

Common Gotchas:

  • Filter Confusion: QAs often expect completed actions to appear when filtering by "Type=Note". They will appear as notes but can be distinguished by the presence of Completed Date and Status="Complete".
  • Edit Rights Post-Completion: Creator can still edit completed actions; assignee cannot. This is different from most task systems and must be validated.
  • Reopening: Creator can theoretically reopen a completed action by changing Status back to Open. Ensure Last Modified Date and Modified By are updated.
  • Dashboard Default: The dashboard widget shows only OPEN actions by default, not completed. Users should not see completed actions cluttering their task list.
Test Scenario: Create an action, mark complete, verify Type="Note" in Browse. Then search for completed date, verify it appears. Finally, as assignee, try to edit completed action; should get permission denied.
Global Note Error Handling (Partial Failures)
ABC-2975

Key Rule: When creating a global note/action on multiple records (from Selective Reporting), if creation fails on some records, the system does NOT roll back successful records. Instead, it reports a summary and allows manual retry.

Why This Matters: Global notes are often created on 100+ records. Rolling back due to a single permission failure on one record would negate all progress, frustrating users. Partial success with reported failures is more practical.

Common Gotchas:

  • Permission Failures Not Obvious: If user lacks Level 1+ permission on a specific company, the global note creation may silently fail on that record. The summary report (e.g., "Created on 99, failed on 1") must be clear.
  • Duplicate Detection per Record: If a duplicate action already exists on record #50 of 100, creation succeeds on 1-49 and 51-100 but fails on 50. The error must specify which record(s) failed.
  • No Rollback, But Audit Trail: All attempted creations are logged. Failed attempts show in audit with reason (permission denied, duplicate detected, etc.).
  • User Retry Burden: Users must manually retry failed records. QA should validate that failed record list is exportable or easily identifiable for manual action.
Test Scenario: Run Selective Reporting with 100 companies. User lacks permission on company #25. Create global note on all 100. Verify: 99 succeed, 1 fails, summary report shows company #25 failed with reason. User can manually create note on #25.
Duplicate Action Prevention
ABC-1923

Key Rule: The system prevents creation of duplicate actions on the same record with identical parameters (same category, type, assignee, due date). A warning is displayed if user attempts duplicate creation.

Why This Matters: Global notes create 100+ records quickly. If user accidentally runs the same global note create twice, duplicates would pollute the system. Prevention is critical.

Common Gotchas:

  • Identical Parameters Definition: What exactly constitutes "identical"? Related To Type + Related To Record ID + Category + Type + Assignee + Due Date? Text can differ and still be considered duplicate? QA must verify exact matching logic.
  • User Intent Ambiguity: User might intentionally create two "Follow-up Call" actions due tomorrow on Company #50 (e.g., one for Sales, one for Support). System preventing this could be frustrating. Warning vs hard block matters.
  • Warning Message Clarity: The warning should show the existing action and ask "Create duplicate anyway?" User should be able to confirm override if intentional.
  • Timing Window: If user creates action, closes browser, later tries to create again, is it still detected as duplicate? Yes, because it checks database, not session state.
Test Scenario: Create action "Call Mike" on Company A, assignee to Bob, due tomorrow. Try to create identical action again. Warning should appear. Override and create. Verify 2 actions exist. Then create third with same params but different text. Verify: if duplicate prevention is text-agnostic, warning appears; if text-aware, no warning.
Prefixed Text on Global Notes/Actions
Core Feature

Key Rule: Global notes/actions automatically prepend origin prefix (e.g., "[Selective Reporting]") to the text. This is not done in Browse display only—it's stored in the database.

Why This Matters: When a user views a note on a company record, they can immediately see that it came from a global action, aiding traceability and preventing confusion about authorship.

Common Gotchas:

  • Text Length Impact: If user enters 500-char note text and prefix adds 25 chars, total is 525. Check database field max length (likely 1000 chars); should be sufficient but QA should verify.
  • Search/Filter Behavior: If user searches for their exact note text in Browse, will they find it? Yes, because search should be substring match. But exact phrase match might not find it due to prefix. Test both.
  • Editing Behavior: If user edits a global note later, should the prefix be editable? Likely NO; prefix is immutable. Only the text portion after the prefix can be edited. QA should verify UI prevents prefix editing.
  • Admin-Configurable Prefix: Is the prefix "[Selective Reporting]" hard-coded or admin-configurable? If configurable, test admin update and verify new globals use new prefix; old globals retain old prefix.
Test Scenario: Create global note "Follow up with manager" via Selective Reporting on Company A. View Company A record. Verify note displays as "[Selective Reporting] Follow up with manager". Edit note. Verify prefix cannot be edited, only text portion. Delete note and recreate; prefix should be identical.
Note Date Back-Dating & Required Field
Core Feature

Key Rule: Note Date defaults to current date but can be back-dated (set to any past date). This field is REQUIRED; notes cannot be created without a date.

Why This Matters: Users might record historical notes (e.g., "We discussed this on Jan 5, today is Feb 1, adding note retroactively"). Back-dating supports accurate historical record-keeping.

Common Gotchas:

  • Far-Past Dates: Can user set note date to 1999? 1970? System should validate but QA should check: are there reasonable bounds (e.g., not before company creation date)? Or is any date allowed?
  • Future Dates: Can user set note date to tomorrow? Next month? Likely YES for planning purposes. Test both past and future edge cases.
  • Created Date vs Note Date: These are different. Created Date is auto-timestamp (today), Note Date is user-editable. QA must distinguish and test both fields.
  • Sort Impact: Browse default sort is by Date (Note Date, not Created Date), descending. Back-dated note will appear in its historical position, not at top. Test sort correctness.
  • Filter Impact: If user filters by date range (Jan 1 - Jan 31), back-dated note to Jan 15 should appear even if created today. Verify filter uses Note Date, not Created Date.
Test Scenario: Create note with Note Date = Jan 5 (back-dated 25 days). Create another note with Note Date = today. View Browse. Verify: Jan 5 note appears below today's note (descending = newest first). Then filter by "Date in Jan". Verify Jan 5 note appears. Filter by "Date in Feb". Verify it does not appear (filter uses Note Date, not Created Date).
Action Checklist Date Offset Calculation
Release 3

Key Rule: Action Checklists include predefined actions with future date offsets (e.g., "+1 day", "+7 days"). When attached to a record, the system calculates each action's due date as: today + offset.

Why This Matters: Checklists standardize task timing. For onboarding, you might want Call on day 1, Email on day 3, Review on day 7. Offsets automate this.

Common Gotchas:

  • Weekend/Holiday Handling: If user attaches checklist on Friday (+1 day offset), is due date Saturday or Monday? System should have rule (skip weekends, skip holidays, or allow). QA should verify documented behavior and test edge cases.
  • Offset 0 Days: Can an action have "+0 days" offset (due today)? Should be allowed. QA should test and verify display.
  • Negative Offsets: Can admin create action with "-5 days" offset? Likely not (past-due task doesn't make sense). Test admin validation.
  • Timezone Impact: If admin is in PT and creates checklist, and user attaches in ET, does date calculation account for timezone? Likely uses server time. QA should verify offset calculation uses consistent timezone (likely server/UTC).
  • Bulk Attachment: If user attaches same checklist to 10 companies on different days, each attachment calculates offset from its own day. Friday attachment gets different dates than Monday attachment of same checklist. Verify each attachment calculates independently.
Test Scenario: Admin creates checklist "Onboarding": Call (+1), Email (+3), Review (+7). User attaches to Company A on Monday, Feb 3. Verify: Call due Feb 4, Email due Feb 6, Review due Feb 10. Then attach same checklist to Company B on Friday, Feb 7. Verify: Call due Feb 8, Email due Feb 10, Review due Feb 14. Dates are independent per attachment.
Permission Model Edge Cases
Security Critical

Key Rule: Access to notes/actions is driven by parent module permissions (Level 1+). No separate N&A permission group. If user loses access to Company A (permission downgrade), can they still view/edit notes on Company A? No—permission inheritance is strict.

Why This Matters: Prevents unauthorized access to company/individual data via notes back-door. If user is removed from company team, notes visibility should revoke immediately.

Common Gotchas:

  • Existing Notes Post-Permission-Loss: If User A had permission, added note to Company X, then permission revoked, can User A still see the note they created? Behavior varies: some systems allow creator to always see created content (soft delete); others enforce strict permission. QA must verify documented behavior and test.
  • Edit Rights Conflict: User B (assignee) may have no permission to Company X but was assigned an action on Company X by User A (who had permission). Can User B edit the action without company permission? Likely NO; action edit should require company permission. Test and verify.
  • Level 1 Boundary: The rule is "Level 1+" required. What is Level 0? Can Level 0 users view notes at all? Likely no view access if Level 0. Test Level 0 user permission boundary.
  • Inherited Permissions: If Company permission is inherited (via Team membership), does Note/Action permission inherit too? Yes, permission model is unified. QA should test with inherited permission scenario.
Test Scenario: User A (Level 1, Company X) creates note on Company X. User B (Level 0, Company X) tries to view Browse filter to Company X. User B should see no results (no Level 1 permission). Then promote User B to Level 1. User B should now see the note User A created.
Browse Default Filter Change (ABC-2005)
ABC-2005

Key Rule: The Browse All screen default filter was changed from "Show All Actions" to "Actions Assigned to Me". When user navigates to Notes & Actions from main nav, they see only their own incomplete actions by default.

Why This Matters: User-centric default reduces cognitive load. Most users are interested in their own tasks, not a firehose of all 500 org actions. This change aligns with task management best practice.

Common Gotchas:

  • Regression Risk High: This is a user-facing change. Old users expecting to see all actions may be surprised. Documentation must be clear. QA should test with diverse user personas.
  • Filter Persistence: If user changes filter (e.g., shows all actions), then navigates away and returns to Notes & Actions, does default filter reset to "Actions Assigned to Me"? Likely YES (apply default on page load). But if user saved custom filter, does saved filter override default? QA should test filter persistence logic.
  • Notification Click-Through: When user clicks notification in bell dropdown, they navigate to Browse with "Actions Assigned to Me" filter. Verify this is consistent behavior.
  • Completed Actions Excluded: Default filter should show only OPEN actions assigned to me, not completed. QA should verify completed actions are excluded from default filter.
  • No Personal Actions: Edge case: User A has no actions assigned to them. Browse with default filter shows empty state. Verify message is helpful (e.g., "No actions assigned to you") not confusing.
Test Scenario: Log in as User A (has 5 actions). Navigate to Notes & Actions. Verify default filter shows only User A's 5 actions (not all 200 org actions). Change filter to "All Actions". Verify 200 actions now displayed. Navigate away, return. Verify default filter reset to "Actions Assigned to Me" (showing 5 actions again, not saved state of 200).

Scenario Thinking

Real-world test scenarios and user journeys for comprehensive coverage.

Scenario 1: Chapter Manager Onboarding Workflow
Core Workflow

User Persona: Sarah, Chapter Manager (Level 1+ on 50+ Companies)

Goal: Onboard new company using standardized action checklist and track completion.

Scenario Steps:

  1. Sarah navigates to Company "ABC Corp" detail screen
  2. Clicks "Attach Checklist" button
  3. Selects "New Company Onboarding" checklist from dropdown
  4. System auto-assigns all actions to Sarah (default) with calculated due dates
  5. Sarah confirms. 5 actions created: Kickoff Call (due +1 day), Initial Documents (due +3 days), Needs Assessment (due +5 days), Proposal Review (due +10 days), Contract Finalization (due +15 days)
  6. Sarah completes Kickoff Call, marks action complete via Browse screen
  7. Dashboard widget updates, Kickoff Call no longer appears in "incomplete actions"
  8. Sarah reopens Browse, applies custom filter "Actions Assigned to Me on ABC Corp". Verifies 4 remaining actions
  9. Sarah reassigns "Proposal Review" to colleague Bob
  10. Bob receives notification, sees action in his "Actions Assigned to Me" default filter
  11. Sarah exports Browse results to PDF for stakeholder meeting

Key Validations: Checklist attachment, date offset calculation, action completion flow, dashboard widget refresh, filter accuracy, export functionality, reassignment notifications.

Test Coverage: Single record workflow, CRUD operations, multi-user collaboration, admin features (checklist), notification system.

Scenario 2: National Office Bulk Action Campaign
Global Feature

User Persona: Marcus, National Operations Manager (Level 1+ on all Companies)

Goal: Cascade policy update actions to all companies in Western region.

Scenario Steps:

  1. Marcus runs Selective Reporting: "All Active Companies where State in [CA, WA, OR]". Results: 45 companies
  2. Selects all 45 companies in result set
  3. Clicks "Create Global Action" button
  4. Fills form: Category="Policy Update", Type="Training Required", Text="Complete new compliance training module X by deadline", Assigns to "Regional Manager" roles (mapped per company), Due Date="Q2 End"
  5. Clicks "Create on All Selected"
  6. System displays progress bar. 44 actions created successfully, 1 fails (company #25—Marcus lacks permission). Summary: "Created 44 actions, Failed 1"
  7. Marcus manually creates action on company #25 (or verifies permission and retries)
  8. All regional managers receive notifications about new compliance training actions
  9. Marcus navigates to Browse, filters by Category="Policy Update", verifies all 45 actions exist with prefixed "[Selective Reporting]" text
  10. Marcus adds note to one company (Company A) with supplementary detail
  11. Marcus exports filtered results (45 actions) to Excel for tracking

Key Validations: Global action creation, partial failure handling, prefixed text, bulk filtering, permission inheritance, export with large dataset.

Test Coverage: Selective Reporting integration, error handling, multi-user notifications, audit trail accuracy.

Scenario 3: Edit & Delete Permission Boundaries
Security

User Personas: Lisa (Creator), Tom (Assignee), Jordan (Other Staff)

Goal: Validate that edit/delete permissions are enforced correctly.

Scenario Steps:

  1. Lisa creates action "Follow-up Call", assigns to Tom, due next Monday
  2. Lisa attempts to edit the action. SUCCESS (creator can edit)
  3. Lisa clicks delete. SUCCESS (creator can delete)
  4. Lisa restores from undo or recreates the action (for next test step)
  5. Tom (assignee) attempts to edit the action. SUCCESS (assignee can edit)
  6. Tom changes assignee from self to Jordan
  7. Tom attempts to delete the action. FAILURE (only creator can delete)
  8. Jordan (new assignee) attempts to edit the action. SUCCESS (assignee can edit)
  9. Jordan changes status to "Complete"
  10. Lisa (creator) attempts to edit completed action. SUCCESS (creator always can edit)
  11. Tom (former assignee) attempts to edit completed action. FAILURE (no longer assignee, cannot edit)
  12. Lisa deletes completed action. SUCCESS (creator can always delete)

Key Validations: Creator-only delete enforcement, creator/assignee edit rights, assignee change impact, completed action permission inheritance, no orphaned records.

Test Coverage: Permission model, RBAC enforcement, state transitions (open -> complete), audit trail.

Scenario 4: Back-Dated Historical Note Documentation
Edge Case

User Persona: Rebecca, Account Manager (retrospective documentation)

Goal: Create back-dated notes to document historical interactions accurately.

Scenario Steps:

  1. Rebecca opens Company X record on Jan 31
  2. Clicks "Add Note"
  3. Sets Note Date to "Jan 15" (back-date 16 days)
  4. Enters text: "Discussed renewal terms. Client prefers 3-year contract."
  5. Saves note
  6. Rebecca navigates to Browse All, filters by "Date = January"
  7. Back-dated note appears in Jan 15 position (not at top, respecting date)
  8. Rebecca then creates current-date note (Jan 31): "Follow-up call scheduled"
  9. Browse default sort (descending): Jan 31 note appears above Jan 15 note (newest first)
  10. Rebecca exports notes for Company X. Verifies both notes export with correct dates
  11. Rebecca filters by date range "Jan 10 - Jan 20". Verifies Jan 15 note appears, Jan 31 note does not

Key Validations: Back-date support, date field acceptance (past dates valid), sort order respects Note Date, filter uses Note Date not Created Date, export date accuracy.

Test Coverage: Date handling, filter accuracy, data integrity, historical documentation support.

Scenario 5: Concurrent Edit & Conflict Handling
Edge Case

User Personas: Paul (Assignee opens edit), Quinn (Creator opens edit)

Goal: Handle concurrent edits without data loss or conflicts.

Scenario Steps:

  1. Quinn creates action "Code Review" assigned to Paul, due Feb 10
  2. Paul opens the action in edit form (does not save yet, just viewing)
  3. Quinn opens the same action in edit form (does not save yet)
  4. Paul changes status to "Complete", saves
  5. Quinn changes due date to Feb 12 (unaware Paul already saved), clicks save
  6. System detects conflict (last-modified-by changed since Quinn opened form)
  7. System displays warning: "This record was modified by Quinn. Your changes conflict. Reload and retry?" Or auto-merges if possible (due date change + status change are non-conflicting)
  8. Quinn reloads. Verifies: Status="Complete" (Paul's change) and Due Date="Feb 12" (Quinn's change) both present OR sees conflict resolution message

Key Validations: Optimistic locking or conflict detection, Last Modified By tracking, merge vs override behavior, user communication on conflict.

Test Coverage: Data integrity, concurrent access, race condition handling.

Scenario 6: Permission Revocation & Data Access Loss
Security

User Personas: Ryan (has permission, creates note), then loses permission

Goal: Verify permission-driven access is enforced strictly.

Scenario Steps:

  1. Ryan has Level 1+ access to Company Z
  2. Ryan creates note on Company Z: "Reviewed contract"
  3. Ryan views Browse, filters by Company Z. Note visible
  4. Admin removes Ryan from Company Z team (permission downgrade to Level 0)
  5. Ryan refreshes Browse page
  6. Ryan filters by Company Z. Result: "No results" or "Access denied" (no note visible)
  7. Ryan attempts to directly navigate to note URL (if direct view is possible). Should get "Access denied"
  8. Ryan attempts to edit the note from history/cache. Should get "Permission denied"
  9. Admin restores Ryan's Level 1+ permission on Company Z
  10. Ryan refreshes Browse, filters by Company Z. Note reappears

Key Validations: Permission inheritance strict (not cached), creator cannot see own notes if permission lost, permission restoration re-grants access, no backdoor access via direct URL.

Test Coverage: Permission enforcement, audit trail, access control boundaries.

Regression Checklists

Structured checklists for testing after each release or code change.

Smoke Test (Pre-Release): 30 Minutes
Mandatory

Run before every release to catch critical regressions.

  • Create single note on Company record. Verify saved and visible in Browse
  • Create single action on Individual record. Assign to another user. Verify visible in Browse with correct assignee
  • Mark action complete via Browse. Verify status changes to "Complete" and Type displays as "Note"
  • View Browse default filter. Verify "Actions Assigned to Me" is default (not "All Actions")
  • Edit action due date. Verify Last Modified Date updates. Verify due date is no longer called "Action Date"
  • Delete note (as creator). Verify delete succeeds and note disappears from Browse
  • Try to delete action (as assignee, not creator). Verify delete fails with permission error
  • Check Dashboard widget. Verify incomplete actions display. Verify quick-complete works
  • Check notification badge on main nav. Verify count accurate (number of incomplete actions assigned to me)
  • Export Browse results to Excel. Verify file downloads and contains expected columns (Type, Related To, Assigned To, Due Date, Status, etc.)
Create & Edit Regression: 1 Hour
Post-Release

Validate creation and edit flows after UI or form changes.

  • Create note: verify all form fields present (Related To Type, Related To, Note Date, Category, Type [optional], Text, Attachment). Verify defaults apply (Note Date = today, Created By = current user)
  • Create action: verify additional fields present (Assigned To, Due Date, Status, Category, Type). Verify Assigned To defaults to Created By. Verify Status defaults to "Open"
  • Test Note Date back-dating. Create note with Date = 30 days ago. Save. Verify Browse shows note in historical position (sorted by Note Date, not Created Date)
  • Test Note Type optional behavior (per ABC-1960). Create note without selecting Type. Verify note saves and no error
  • Test attachment upload. Upload PNG image (5 MB). Verify thumbnail displays. Try upload 15 MB file. Verify rejection with file size error
  • Edit note: change text, date, category. Verify save succeeds. Verify Last Modified Date updates. Verify Modified By = current user
  • Edit action: change assignee, due date, status. Verify save succeeds. Verify all fields update correctly. Verify Last Modified Date updates
  • Try edit action as assignee (not creator). Verify edit succeeds if assignee. Change back to original assignee
  • Test edit action to "Complete". Verify Status changes to Complete, Completed Date auto-fills, Type displays as "Note" in Browse
  • Test reopen completed action (edit Status from Complete to Open). Verify succeeds. Verify Completed Date clears (or persists for audit—verify documented behavior)
Global & Bulk Operations Regression: 1.5 Hours
Post-Release

Validate global note/action creation and action checklists.

  • Run Selective Reporting (Companies). Select 10 companies. Create global note "Test Note"
  • Verify global note created on all 10 with prefixed text "[Selective Reporting] Test Note"
  • Verify prefixed text stored in database (Edit note, confirm prefix is immutable)
  • Create global action with due date. Verify all 10 actions created with same due date, assigned to current user
  • Test partial failure: Run Selective Reporting with 10 companies. User lacks permission on company #5. Create global action. Verify 9 created, 1 failed. Verify summary message shows failure details
  • Test duplicate prevention: Create global action on 10 companies. Immediately retry. Verify warning "Action already exists on some records". Confirm override to create duplicates or cancel to prevent
  • Admin: Create Action Checklist "Test Checklist" with 3 actions (offsets +0, +3, +7 days). Assign to Company module
  • User: Navigate to Company record. Click "Attach Checklist". Select "Test Checklist". Verify 3 actions created with correct due dates (today, +3, +7)
  • Admin: Copy the checklist. Verify copy successful, original unchanged. Assign to Individual module. Verify copy shows as separate checklist
  • Admin: Disable the checklist. Verify disabled checklist no longer appears in "Attach Checklist" dropdown
  • Test global action assigned to "Regional Manager" role. Verify action assigned correctly per role mapping (different regional managers for different companies)
Browse & Filter Regression: 1 Hour
Post-Release

Validate Browse screen, filters, sorting, pagination, and export.

  • Navigate to Browse All. Verify default filter applied: "Actions Assigned to Me" (not "All Actions")
  • Verify default sort: Type ascending (Actions above Notes), then Date descending (newest first)
  • Create 15+ notes/actions to test pagination. Verify pagination controls present. Verify page size selector (25, 50, 100 items)
  • Filter by Type="Action". Verify only actions displayed (notes hidden)
  • Filter by Type="Note". Verify only notes displayed (actions hidden). Verify completed actions appear as Type="Note" and are visible in this filter
  • Filter by Related To Type="Company". Verify only company notes/actions displayed
  • Filter by Related To (search "ABC Corp"). Verify search returns only records matching company name
  • Filter by Assigned To="[Specific User]". Verify only that user's actions displayed
  • Filter by Due Date range "Jan 1 - Jan 31". Verify only actions with due date in range displayed. Verify date uses Due Date field (renamed from Action Date)
  • Combine multiple filters: Type="Action" AND Assigned To="Me" AND Due Date < today. Verify all filters apply (intersection, not union)
  • Verify sort options work: sort by Due Date ascending/descending, Created By A-Z, Last Modified descending. Verify default sort (Type, then Date) still works
  • Export filtered results (5-10 records) to Excel. Verify all visible columns exported (Type, Related To Type, Related To Name, Created By, Assigned To, Date, Due Date, Status, Last Modified, Text). Verify Excel formatting readable
  • Export to PDF. Verify PDF generates successfully, contains expected data, formatting clear
  • Test "Actions Assigned to Me" filter includes completed actions. Filter by Status="Complete". Verify completed actions visible. Verify default filter excludes them (shows only Open)
Permission & Security Regression: 1 Hour
Security Critical

Validate permission inheritance, edit/delete boundaries, and access control.

  • User with Level 0 (no permission) tries to create note on Company. Verify rejected with "Permission denied"
  • User with Level 1+ creates note on Company. Verify created successfully. Verify Level 0 user cannot see note in Browse
  • Admin downgrades user from Level 1+ to Level 0 on Company. User refreshes Browse. Verify note no longer visible
  • Admin upgrades user back to Level 1+. User refreshes Browse. Verify note reappears
  • Creator creates action. Creator can edit: Verify SUCCESS. Creator can delete: Verify SUCCESS
  • Assignee (not creator) tries to edit action. Verify SUCCESS (assignee can edit)
  • Assignee tries to delete action. Verify FAILURE (only creator can delete)
  • Other user (neither creator nor assignee) tries to edit action. Verify FAILURE or restricted access depending on permission model
  • Creator marks action complete. Assignee tries to edit completed action. Verify FAILURE (assignee cannot edit completed actions)
  • Creator can edit completed action. Verify SUCCESS (creator can always edit, even after completion)
  • Test permission inheritance from Team membership. User added to Company Team (inherits Level 1+). Verify can view notes on that Company. User removed from Team. Verify notes no longer visible
  • Test "Assigned To" permission: User assigned action on Company they have no Level 1+ permission on. Verify user cannot view or edit action (permission-driven, not assignee-driven access)
Dashboard & Notification Regression: 45 Minutes
Post-Release

Validate dashboard widget, badge count, and notification system.

  • Create 5 open actions assigned to current user. Navigate to Dashboard. Verify widget displays all 5 actions
  • Verify actions sorted by age (oldest first, not newest)
  • Verify each action shows: Date Assigned, Assigned-by (Created By), Related-To Entity
  • Click action in widget. Verify view modal opens
  • Use "Quick Complete" button on action in widget. Verify status changes to Complete
  • Refresh Dashboard. Verify completed action no longer displays (widget shows only open)
  • Verify badge count on main nav Notes & Actions menu. Should show number of incomplete actions assigned to me
  • Create new action assigned to me. Verify badge count increments immediately (or on next page load)
  • Mark action complete. Verify badge count decrements
  • Check bell icon / notification dropdown. Create action assigned to me. Verify notification appears in dropdown
  • Click notification. Verify navigates to Browse with "Actions Assigned to Me" filter applied
  • Test overdue notification: Create action with due date = yesterday. Verify system sends "overdue" notification or indicates overdue status
  • Test due-soon notification: Create action with due date = tomorrow. Verify system may send "due soon" notification (48-hour warning, if feature exists)
  • Test reassignment notification: Create action assigned to User A. Change assignee to User B. Log in as User B. Verify notification received about reassignment
Admin Management Regression: 45 Minutes
Post-Release

Validate admin screens for managing categories, types, and checklists.

  • Admin: Navigate to Admin > Manage Categories. Verify list of existing categories displays
  • Admin: Create new category "Test Category". Save. Verify appears in list and is Enabled by default
  • User: Create note with new category. Verify category selectable and saves correctly
  • Admin: Disable "Test Category". Verify no longer appears in category dropdown for new notes
  • Admin: Re-enable category. Verify reappears in dropdown
  • Admin: Delete category (if allowed). Verify deletion succeeds or shows error if in-use
  • Admin: Manage Types. Create type "Test Type" with description and optional prefix "[TT]". Save
  • User: Create action with new type. Verify type selectable. Verify prefix displays on Browse if configured
  • Admin: Edit type. Change prefix to "[TEST]". Save. Verify new actions use new prefix; old actions retain old prefix
  • Admin: Manage Checklists. Create checklist "Test Onboarding" for Company module with 3 actions (+0, +2, +5 days). Save
  • Verify checklist enabled by default. User can attach to company record
  • Admin: Copy checklist. Verify copy created with new name. Verify original unchanged. Assign copy to Individual module
  • User: Try to attach "Test Onboarding" to Company (should work). Try to attach to Individual (should fail or not show copy). Try to attach copied checklist to Individual (should work)
  • Admin: Disable original checklist. Verify no longer available for attachment. Copied checklist still available (if different module)
  • Admin: Edit checklist. Modify action due date offsets. Save. Verify new attachments use new offsets; old attachments unaffected

Environment & Data Setup

Test environment configuration, data prerequisites, and setup procedures.

Test Environment Requirements

Supported Environments: Dev, Staging, UAT (production testing separate). All Notes & Actions functionality available in all non-prod environments.

Database Backup: Ensure full backup available before destructive test runs. Restore capability tested and documented for regression purposes.

Browser Support: Chrome (latest 2 versions), Firefox (latest 2 versions), Safari (latest version on macOS). IE not supported. Mobile browsers (Chrome/Safari mobile) basic testing recommended.

Performance Baseline: Notes & Actions browse loading <2 seconds with 1000+ records. Global action creation on 100 records <30 seconds. Establish baseline before load testing.

👥Test Data & User Personas

User Personas to Create:

  • Chapter Manager (Level 1+): Access to 10-20 companies. Can create/edit notes/actions. Typical user for single-record workflows
  • National Manager (Level 1+ all companies): Bulk action creation via Selective Reporting. Admin access to manage categories/types/checklists
  • Regional Manager (Level 1+ 50+ companies): Action checklist attachment, multi-record management
  • Staff Member (Level 1+ limited): Assignee for actions. Can edit but not delete. Testing assignee-only permissions
  • Viewer (Level 0): No access to any notes/actions. Testing permission boundary

Company Test Data: Create 100+ test companies with mix of permission levels assigned to test users. Use realistic company names, contact info. Flag some as "high-priority" for notification testing.

Action Test Data: Pre-populate 200+ open actions assigned to various users with mix of due dates (past, today, future). Create 100+ completed actions for status display testing. Create 50+ notes with back-dated dates.

🔧Data Setup Procedures

Category & Type Setup: Pre-create standard categories (General, Follow-up, Issue, Documentation) and types (Call, Email, Meeting, Documentation, Review) in admin section. Test environment should reflect production configuration.

Checklist Setup: Create 3-5 standard checklists for testing:

  • "New Company Onboarding" (5 actions, +1 to +15 days)
  • "Individual Review Cycle" (4 actions, +0 to +30 days)
  • "Quarterly Check-in" (2 actions, +0 to +7 days)

Permission Setup: Use realistic permission matrix reflecting production (not all users have access to all companies). Test with various permission levels to ensure inheritance works correctly.

📋Pre-Test Checklist (Every Test Run)

Before starting regression testing:

  • Verify environment database is clean or restore from known good backup
  • Clear browser cache and cookies (or use incognito mode)
  • Verify all test user accounts exist and have correct permissions
  • Verify standard categories, types, and checklists are configured
  • Verify at least 100 test notes/actions exist for browse/filter testing
  • Verify Selective Reporting tool is accessible and returns expected results
  • Verify Dashboard loads without errors
  • Verify notification system is functional (test with known working scenario)
  • Verify attachment upload feature is functional (test with small PNG)
  • Document any environment changes or anomalies that may affect test results

🐛Bug Reporting & Triage

Bug Report Template: Title, Description, Steps to Reproduce, Expected Result, Actual Result, Environment (Dev/Staging/UAT), Browser, User Permission Level, Severity (Blocker/Critical/High/Medium/Low).

Severity Definitions:

  • Blocker: Feature completely non-functional; blocks critical user workflow (e.g., cannot create notes at all)
  • Critical: Feature broken; significant workaround required (e.g., cannot mark actions complete but can via API)
  • High: Feature partially broken; minor workaround possible (e.g., filter not working for one data type but others work)
  • Medium: Cosmetic or minor functionality issue (e.g., button label incorrect, field order unexpected)
  • Low: Nice-to-have fix; no workaround needed (e.g., tooltip wording improvement)

Jira Integration: Link bugs to related features/stories. Reference ABC-XXXX Jira tickets in test reports. Include "Regression" label if bug is regression from prior release.

📊Test Metrics & Reporting

Key Metrics to Track:

  • Total test cases executed, passed, failed, skipped
  • Defect density (bugs found per 100 lines of code or per feature area)
  • Regression test pass rate (should be >95% for stable features)
  • Test coverage by feature (% of features with automated/manual tests)
  • Cycle time (time from bug report to fix to re-test closure)
  • Release readiness assessment (all blockers/criticals resolved)

Report Template: Executive Summary, Test Scope, Test Results Summary, Defect Summary (by severity), Coverage by Feature, Risks/Concerns, Recommendations (ready for release, conditional, hold).